快速开始

最后于 2025年3月28日 更新

APO 分为两部分：

• APO-server: APO 服务侧组件
• APO-one-agent: APO 用户侧组件，用于采集Kubernetes集群或者虚机环境下被监控业务以及集群、主机信息。

本文档包含使用 Helm 在同一 Kubernetes 集群上安装和运行 APO-server 与 APO-one-agent 的说明。

注意

本文档仅供 POC 测试阶段快速部署使用，为非持久化配置，请勿在生产环境中使用。如需在生产环境中使用，推荐将 APO-server 安装在独立环境中，安装方式请参考安装 APO-Server。

准备工作

要使用 Helm 安装 APO，请确保已完成以下操作：

• 准备 8核16G 的硬件资源，磁盘资源根据您的监控规模而定，最小不低于50G。
• 在计算机上安装 Kubernetes 服务器。有关安装 Kubernetes 的信息，请参阅官方文档安装 Kubernetes。也可参考简化安装方式Sealos 部署 Kubernetes集群（需8核16G）。
• 安装 Helm 的最新稳定版本。有关安装 Helm 的信息，请参阅安装 Helm。

设置 APO Helm 仓库

要设置 APO Helm 存储库，以便在计算机上下载正确的 APO Helm charts，请完成以下步骤： 使用下方命令添加 apo Helm 仓库

helm repo add apo https://apo-charts.oss-cn-hangzhou.aliyuncs.com
helm repo update apo

部署 APO Helm charts

运行以下命令，部署 APO-server 与 APO-one-agent。

# BASEURL 修改为浏览器访问 APO-server 的IP或者域名地址,访问url若有端口必须填写
export BASEURL=xxx.xxx.xxx.xxx:xxxx

helm install apo apo/apo -n apo --create-namespace \
--set apo-one-agent.enabled=true
--set global.baseURL="http://$BASEURL"
--set global.image.repository="registry.cn-hangzhou.aliyuncs.com/kindlingx"
--set global.image.eeRepository="registry.cn-hangzhou.aliyuncs.com/kindlingx"
--set global.language=zh

配置1： apo-one-agent 默认监控 apo 以及 kubernetes 系统组件以外的所有组件，更多配置参考如何配置Kubernetes环境OneAgent自动监控范围

配置2： apo-one-agent 中的 Go 语言 Trace 探针 Grafana—Beyla 默认处于关闭状态；Beyla 运行需求系统内核版本 5.8 及以上，详见 Grafana-Beyla 官方文档;如需开启 Grafana-Beyla 采集 Go 语言服务 Trace 数据，请在部署命令后增加参数--set apo-one-agent.grafanaBeyla.enabled=true

注意

本文档仅供 POC 测试阶段快速部署使用，为非持久化配置，数据库组件重启会导致数据丢失或者服务崩溃；请勿在生产环境中使用。如需在生产环境中使用，推荐将 APO-server 安装在独立环境中，安装方式请参考安装 APO-server。

验证

输入下方命令检查pod是否启动成功

kubectl get po -n apo

信息

安装成功后需重启目标被监控服务！！！ 遇到问题 ：

• apo-one-agent如未准备就绪处于 6/7 或 6/8 状态，可以通过查看文档《解决ebpf-agent始终未就绪问题》 和 《解决grafana-beyla始终未就绪问题》）进一步排查

访问 APO

您可以通过以下方式访问 APO，其中 NodeIP 为集群中任意一个节点的 IP 地址。

• APO 向导式可观测性平台地址：http://<NodeIP>:31364；默认用户名/密码：admin/APO2024@admin

• APO 向导式可观测性平台工作流页面；默认邮箱/密码：admin@admin.com/APO2024@admin

• Grafana 地址：http://<NodeIP>:31364/#/system-dashboard

DEMO 测试

我们提供应用 DEMO，您可以使用一键安装命令帮助您验证 APO 系统的功能完整性。 详情请见：一键部署测试服务 Demo

更新与卸载

更新 APO Helm charts 配置

如果您的 APO 需要更新使用下方命令进行更新

helm upgrade apo apo/apo -n apo \
--set apo-one-agent.enabled=true

卸载 APO Helm charts

kubectl delete clickhouseinstallation apo -napo
helm uninstall apo -n apo
kubectl delete ns apo

更多配置

本文档提供的为 APO 部署的基础配置，如果您要进行更多配置更改，请从 APO Helm Charts 库中下载values.yaml文件：

helm show values apo/apo > values.yaml

更多安装方式

• 安装 APO-Server: 推荐采用此安装方式将APO-server与被监控服务隔离在不同环境中。
• Kubernetes 安装 OneAgent: 使用 Helm Chart 在 Kubernetes 上安装和运行 APO-one-agent，监控 Kubernetes 集群中的服务。
• 传统服务器安装 OneAgent: 支持监控传统服务和采用 Docker 启动的服务。

部署 APO 社区版

默认情况下，APO 会安装企业版，相比于社区版，企业版提供更多数据分析能力，区别请查阅版本区别。

通告

当前APO的企业版本功能正在免费公测中🔥！！！

如果需要也可以使用社区版本，请在安装命令后增加参数

--set global.edition=ce